@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#SSS@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::%%%SS@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%::::::::%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@::::::::::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:%:::::::S@@@@@@@SSSSSS@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%SS:::::S@@@@@@S::::::::::S@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@     @@@@@@@@@@@@@@@@@S%::::%S@@@@@S::::::::::::::@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@@@@@S:::::#@@@@@@::SS@@@@@S::::::%@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@@@@:::::%##%:S@##S@@@@@@@@@::::::@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@@@:::::%@#:::::S@@@@@@@@@@@:::::S@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@@::::::S%::::::S@@@@@@@@@@@@::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@:::::::%::::::S@@@@@@@@@@@@@::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@:::::::#S:::::#@@@@@@@@@@@@@@::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@     @@@@@@@@@@@S:::::S#:::::%#@@@@@@@@@@@@@@::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@SSS@@::::%#S::@@@@@@@@@@@@S::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@::::%@#::::@:@@@@@@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@::::SS%::::::::@@@@@@@S:::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@:::::%:::S::::@::@@@@@S:::::@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@:::::::::@@S::@@:::SSS::::::S@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@S:::::::@@@#S@@@@:::::::::::@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@SS::S@@@@@@@@@::::::::::@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S:::::::#@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@SS:::SS@S:::SS@S@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@     @@@@@@@@@@@@@@S@@@@@@@S::::::::%@@@@@@@S::S@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@S:::SS:::S@S:::::@@@@@@@@#::::@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@S:::::%@@@@:::::@@@@@@@S:::::%@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@:::::SSSS@::::@@@@@@S::::::S@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@S::::@S::%::::@@@@S::::::S@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@::::@S%#S:::S@@@::::::S@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@:::::S@#::::@@@@S:::SS%S@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@::::%::::#@@@@@@S@@@%:::@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@S%::%S::SS#%#@@@@@S::::S@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@S::S%:%%S@@@@@@S::::%#@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@     @@@@@@@@@@@@@@@@@@S:::::#@@@@@@@@:::::S@#S@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S:::%:::#%%S@@@@::::::%%:::S@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@S::::SSS:::::::@@@@:::::::::::::@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@SS::::S@@%:::%:::S@@@:S::S@@S::::::@@@@@@   @@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@##:::::@@@%::S@S::#@@@::@@@@@@%:::::@@@@@@ @@@ @@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@SS@@@@@S@%S::S#@@S:@@@@@@::::::@@@@@@@ @@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@SS@@@@:::@@::S::@@@@S:::::S@@@@@@@@ @@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@S:::@@@::@@@::::S@@@S:::::S@@@@@@@@@ @@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@::::%S@::S@@@:::%@@:::::S@@@@@@@@@@@ @@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@S::@S::::@@@@SS@S::::S@@@@@@@@@@@@@ @@@ @@@@@@@@@@@@
@@@@@@@@@   @@@@@@@@@@@@@@@@@S@@@S:::@@@@@#::::S@@@@@@@@@@@@@@@@   @@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@#%@@@@@SS::S@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S#SS@@@@#S@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@   @@@@@@@@@@@@@@@@@@@@%:::::S@@@@@@@@@@@@@@@@@@@@@@@@     @@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@:::::S@@@@@@@@@S:::SS@@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@@@:::::%:S@S:::S::::::::@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@ @@@@@@@@@@@@@@@@@@@@@@S::::::::%:::::::::::::@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@  @@@@@@@@@@@@@@@@@S:::::::::%S@:::::::::::::@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@@@ @@@@@@@@@@@@@@S:::::::::%S@@@S::::S@:::::@@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@#S::::#:::%@%%:S@::::@@:::::@@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@   @@@@@@@@@@@@@@@@@@@@#:::S%::::%:::::@::::@@@@@@@@@@     @@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S:::::::SS@@:::::@@S::S@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S::::::::#@@@@:::::@@@S:::@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@     @@@@@@@@@@@@SS:::::%:::::#@@@@:::::@@@@::::@@@@@@@     @@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@S:::::::%#S:::::::%@@:::::@@@@@::::@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@S::::::S@#:::#@:::S@@::::::@@@@::::@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@SSS@@@%::::#@::::@@::::::@@@@:::::@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@@@@@::::::::::::@@::::::SSS::::::@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@@@@::::::@::::::@@:::::::::::::::@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@ @@@@@@@@@@@@@@@@:::S:::@@#::::@@::::::@SS:::::S@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@     @@@@@@@@@@@@@:::S@:::@@#::::@@::::::@@@@S::S@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@S::S@@@::::%:::::@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@%SS@@@@@:::S@::::S@@::::S@@@@@@@@@@@@@@@ @@@ @@@@@@@@@@@@
@@@@@@@@@   @@@@@@@@@@@@@@@@@@@@:S@@::::@@@::::@@@@@@@@@@@@@@@@ @@@ @@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@@@@%%S@@@::::@@@@@@@@@@@@@@@@ @@@ @@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::S@@@@@@@@@@@@@@@@ @@@ @@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@#::%%:SS@S:%@@@@@@@@@@@@@@@@@@ @ @@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@@S:::::::%:@@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@@@@:::::::::@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@@@@@@S::::::::S@@@@@@@@@@@@@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@   @@@@@@@@@@@@@@@@@@@@@@@#SS@@@@@@@@@@@@SS:::::S@@@@@@@ @@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@S@@@@@@@@@@@@@@@@SSSS:::::::::::::@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@S:::SS@@@@SSSS:::::::::::::::::SSS@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@:::::::::::::::S:::::###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@  @@ @@@@@@@@@@S::::::::S::S@@@:::::SSSS@@S@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @ @ @@@@@@@@@@@@SSSS@@@#::@S:%:::::S:::::::@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@  @@@@@@@@@@@@@@@@@@S:::SSS@:::::@@@::::::@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@@:::::@@@:::::@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@@:::::S@@@:::::@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@::::::@@@@:::::@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@ @@@ @@@@@@@@@@@@@@@@:::::S@@@@:::::@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::::@@@@@:::::S@@S:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S::::@@@@@:::::S%::::::S@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::S@@@@@:::::@@S::::S@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@SS@@@@@@:::::@@@@SS@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@::::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@:::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@S::@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@%@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

--------------------------------------------------------------------------------


			          Illusion City

                        Copyright (c) Microcabin Corp. 1991


      Japanese to English translation for MSX Turbo R by MSX TRANSLATIONS

                                 version [1.0.0]

                             Released on 13.09.2025



							     NEW IN THIS VERSION
--------------------------------------------------------------------------------
First public release.



									   STORY
--------------------------------------------------------------------------------
You can read the two prologue stories in the Databook (PDF).



									FEATURES
--------------------------------------------------------------------------------

 [ General ]

 - Full translation of all the texts on all 8 disks (Intro, Main Game, and
   End Demo/Credits).
 - Translated an alternative version of Illusion City where a few scripts and
   map data are different from the most common version (Disk 2 and Disk 8).
 - Translation of the manual for backstory, more details, and better
   translations of items, weapons, magics, etc.
 - Decompiled all 151 Event (EVT) scripts and 4 Scene (SCN) scripts with the
   ability to compile them back into the game (later one EVT script was removed
   as a redundant and 4 SCN made into one).
 - Discovered and fixed duplicate scripts and unused scripts in the game.
 - Recreated in-game compressor to be able to alter GFX and data and compress it
   back into the game.
 - Created new special dual compression for the script files in order to fit
   them in the same space or less as the original game. All scripts unpack as
   they print on the screen.
 - Translated graphics where it was required.
 - Dumped scripts from the PC-98, Sharp X68000, and Mega-CD version of the game
   to enrich MSX texts.
 - Translation working on 256KB or 512KB Turbo R like the original game.
 - MIDI Music fully working for both Turbo R 256KB (with MuPack) and 512KB with
   MSX-MIDI.
 - Added newer version 1.02 of ARMI.COM from MSX Fan 14 to DISK 1 and translated
   it. You can play RCP MIDI files with it.
 - Added a translated version of ARMI.DOC for ARMI.COM 1.02 to DISK 1.
 - Created 4MB (real size 3.6MB using "AI" optimization) ROM version of the
   game - almost instant loading speeds, no "change disk" messages plus other
   improvements.
 - Added FlashROM save to the ROM version of the game (now supports ASCII16-X
   mapper, MegaFlashRom SCC+SD, Carnivore 2). Tested on openMSX and real hardware.
 - Disassembled Fray.DOS and the game initialization routine to improve
   multi-mapper support and ensure full MuPack compatibility. Code was heavily
   optimized for size, with many new options and improvements added.
 - Fixed the issue when MIDI initialization would crash if the data buffer was
   not empty before loading the data.
 - Many improvements to the game to remove some small flaws.



 [ Intro ]

 - Altered texts and graphics appearance to make it better for English texts.
 - Added space to the "ILLUSION CITY" logo and re-synchronized with the
   lightning animation.
 - Added English text to the game logo (similar to the game box art).
 - Fixed hotel/ skyscraper name GFX from "Horizn" to "Horizon" on the
   billboard.
 - Added palette pulsing to the title screen.
 - Created a variety of fonts for all intro screens.
 - Added black contour for the texts that overlap pictures.
 - Moved red image(s) to better position it for wrapping the texts in English.



 [ Main Game ]

 - Completely rewrote in-game print subroutines with support of a new lowercase
   variable-width font.
 - Moved all printing from character-based to pixel-based.
 - Added the ability to auto-center texts, shift texts, and more.
 - Added automatic color changing to characters names during text
   conversations.
 - Added multi-color texts during battles.
 - Expanded the post-battle window to display five lines, allowing users to view
   all text without the need to scroll.
 - Sped up printing by eliminating the VRAM buffer. Text now prints directly
   from RAM to screen.
 - Optimized and improved menu bar code (line drawing) and visual appearance.
 - Adjusted in-game windows to accommodate bigger English text.
 - Adjusted dimensions of menus to fit English texts nicely.
 - Added ability to the game to automatically select window size based on the
   amount of text to be printed (for menu selection window).
 - Added ability to store longer names of items/weapons/magic/etc.
 - Fixed Scene (SCN) script on disks 5/6/7. Added events texts that were
   missing.
 - Corrected continuity errors with NPCs on disks 3, 4, and 5. Added new
   messages to the NPC on disk 2 to address a previously missed event.
 - Resolved an issue where the NPC on disk 3 displayed a message prematurely.
 - Included the missing Dasa release message for Yama.
 - Removed a delayed animation after going back on disk 5.
 - Fixed a bug related to the Death Mask, preventing players from dying even when
   the mask was removed and making it impossible to defeat the boss.
 - Created a new way of displaying magics in menus.
 - Improved text on menu buttons of the main game screen.
 - Extended size of the battle menu to fit bigger texts and menu options.
 - Added current level for each character during battle.
 - Added a new player status mode where you can see the current player status as
   "Normal/Confused/etc...".
 - Made items like Petrify Needle unusable during boss battles to ensure
   balanced difficulty.
 - Resolved (removed) the ability to scroll through all Protective Gear and
   Weapons in the [Weapon & Armour Store].
 - Re-coded magic menu to have one menu line instead of three. This is done to
   fit full English magic names.
 - Added gender-correct messages when he/she cannot use magic.
 - Translated original in-game [debug menu].
 - Fixed a major issue where blue "disabled" magics were usable during boss
   fights.
 - Fixed major issue with party almost never able to escape. The whole code for
   it was wrong. Now it works as intended.
 - Fixed a bug where the cursor could move off-line in the "Select Character"
   window.
 - Improved magic usability: the cursor now remains on the same line after
   casting spells.
 - Made adjustments to game INT to improve screen split and palette change for
   portraits.
 - Found and fixed an issue with player animation in the final boss fight.
 - Corrected the bullet type for the Thompson submachine gun so it uses the same
   bullets as in real life.
 - Fixed a major issue with pre-generated enemy pointers causing multiple
   problems, including fleeing from a battle.
 - Re-coded subroutine for escape to work as intended.
 - Made special code to fit Ensealed Spell Shells in the item list and during
   battle mode.
 - Added items that were missing in the game (some located in stores and some in
   maps). Some of them were present in the manual.
 - Translated "ELEVATOR" GFX to "LIFT".
 - Implemented text delay adjustments and other optimizations during battles to
   enhance readability and playability.
 - Restored functionality that shop contents are dependent on level.
 - Fixed a skill level issue that caused characters with a high skill level to
   almost never hit anymore.
 - Fixed a bug where a character with a debuf on his agility to become so fast
   that he can go multiple times before the monster could.
 - Fixed some continuity errors for some NPCs.
 - Implemented the unused music (ROM version only).
 - Improved screen split when in discuss mode or when in an event. 



 [ End Demo | Credits ]

 - Thoroughly overhauled the End Demo and Credits printing subroutines, now
   supported by three newly introduced fonts.
 - Re-synchronized the End Demo's English text to harmonize with the
   animations and music.
 - Incorporated English text into the game logo, mirroring the aesthetic of the
   game's box art.
 - Conducted thorough research on the game's staff to ensure full names are
   accurately included in the Credits.




                                                          VERSION TO APPLY IT TO
--------------------------------------------------------------------------------
The patch was created against these disk images (SHA-256):

Disk 1: 5CED541B72AC78067B99193537B4BAD45C41F7D36BF674A6ECDED1C9AFD2F100

Disk 2: 0B15D64C3FF77CD478A6095E1C4FC6B09806677056A7894A019FBF0B1DC923B4

Disk 3: CB6FBFD217FAC742591E85B3835A635204C6967191E6F16C985069853A157343

Disk 4: 706E5EF7CD82A4BED07248F5B30F15DF2D6BD30741D657D71AE38BB173BAD848

Disk 5: 1D55A9E933FFC3A2B4BADDCD92B5746ECD8F5145267CA51B1A95AB2566AFDD3D

Disk 6: 5575F2BB1D464EDE3FFBEA25CAE28B191024B834040148F8CE3D783489DD6491

Disk 7: AA93290974EA38E4E8C4CEAE7A116220538DC85DA9DDD3520B1FCF4C468F9DF9

Disk 8: 00483B61F499FE239ADB441E85E814BCCDEBCC67F554A46701BD809CBFBBDF8B


Disk 1 with empty saves (use IC100C1S.IPS to remove saves if required): 

167657559EB1EFE263B4156FC6925F96C7DBAE7E8B45A03157C7B3922E95E228


To save to a User Disk you can use any MSX-formatted 2DD disk. This disk does
not need to be translated.

If your Disk 1 has saves on it, the SHA-256 value may differ.




                                                          ADDITIONAL INFORMATION
--------------------------------------------------------------------------------
* Inventory full, can't take off equipment, can't use items, etc. *

Sometimes the game does not show an error message when an action is impossible;
you will only hear a "denied" sound. If you cannot take new items or remove
equipment, your inventory is likely full. Sell or drop something (drop means
you lose it forever). Items or magic that a character cannot use may cause a
similar situation without a warning. We plan to add messages in a later update.

* Shops other than Doc's level based equipment

The game had a mechanic that depending on level equipment was shown. It was
not fully working, resulting in weird behaviour in the shops while scrolling 
through the inventory. It is fixed for weapon shops and other shops that sell
offensive or defensive gear. The same shop will sell you different weapons 
depending on your level.

*SPOILERS - Debug Mode*

On the map, hold B (or SHIFT). While holding it, quickly enter:
Up, Up, Down, Down, Right, Left, Right, Left, then press A or SPACE/RETURN
(still holding B/SHIFT). The movement pointers in the cursor display must not
flash during entry.


Cheat (PC-98, could not reproduce on MSX):
Hold KANA + CAPS, then hold GRAPH while someone is down; that character should
revive (reportedly do not use SHIFT).




									CONTROLS
--------------------------------------------------------------------------------

LEFT, RIGHT, UP, DOWN: Move

	  LEFT, RIGHT: When buying or selling in stores, using/ reordering/  
                       dropping items, equipping/ unequipping weapons, and using
                       items in battle LEFT and RIGHT flips you to the next page
                       of relevant items or equipment.

	     UP, DOWN: When attacking with a weapon that can switch between 1 or
                       multiple targets, UP selects all possible targets and 
                       DOWN switches back to 1 target. The same goes for magics
                       that can target 1 or multiple players or enemies.

		Mouse: Full mouse control

              ESC, BS: In-game menu

	        SHIFT: Auto-run or cancel an option

		SPACE: Select an option

                 STOP: With mouse connected, switch back to cursor/joystick.
		       Press again (with mouse in port 2) to resume mouse.




									    MIDI
--------------------------------------------------------------------------------
- ON MSX -
If you want to play with MIDI, you need MuPack on a Turbo R FS-A1ST or MSX-MIDI
on a Turbo R FS-A1GT. Other interfaces (e.g., MIDI Saurus) are not supported.


- Roland SC-88 (or compatible) in CM-64/CM-32 mode -
1) Connect to your MSX and audio output/headphones.
2) Hold SELECT, press the Previous Instrument (left arrow) button.
3) "All" and "Mute" blink. Confirm with "All", cancel with "Mute".
4) CM-64 mode initializes.
5) Boot the game and select MIDI music.


- MT-32 -
1) Connect it up to your MSX and to an output device or a pair of headphones.
2) It should work as is, but some instruments might be missing. Games composed
   on a CM-32L will work on a revised MT-32 (aka "MT-32 New"), but some sounds
   may be missing (for instance the lightning effect in the opening demo). A
   revised MT-32 (aka "MT-32 New") should work fine, but we didn't have one for
   testing. The original MT-32 (aka "MT-32 Old") should also work but some songs
   might sound not quite right if played back. Developers were not always aware
   of different revisions.
3) Boot the game and select MIDI music.


- MT-32 Pi (cost effective way of being able to play on real hardware) -
1) Place CM-32L ROMs on the Pi (follow its instructions).
2) Connect it up to your MSX and to an output device or a pair of headphones.
3) Boot the game and select MIDI music (lightning SFX in intro works too).


- MIDI-PAC v1/v2 -
1) This does not play MIDI files; it translates FM+PSG to MIDI.
2) Connect it up to your MSX and to an output device or a pair of headphones.
3) Boot the game and select **FM** music! The FM+PSG music will be turned into
   MIDI music.


- ON EMULATOR (e.g., openMSX) -
1) Install Munt with CM-32L CONTROL and PCM ROMs.
2) Set up a Virtual MIDI Driver (using LoopMIDI) on your PC.
3) Install a MIDI Router (using MIDI-OX). Select your LoopMIDI port under both
   MIDI Inputs and Outputs. Use MT-32 Synth Emulator in MIDI-OX as an Output.
4) Set up PCM Sound Emulation (can be done using Roland Sound Canvas VA (need
   to pay for it) or VirtualMIDISynth with soundfont (free)).
   Use SC-55 or similar soundfonts. Set the MIDI input to the LoopMIDI port
   created earlier.
5) You need to route the MIDI signals from your application to both Munt and
   your PCM synthesizer: Ensure both Munt and your PCM synthesizer are selected
   under MIDI Outputs.

The MIDI signals should now be routed through LoopMIDI, split by MIDI-OX, and
sent to both Munt and your PCM synthesizer.


You can download the file with detailed instructions and some files here:

https://drive.google.com/file/d/1_vGX6ghbno-FfaCoq-8nL9cuK5KKIoSF/view?usp=sharing




									   FILES
--------------------------------------------------------------------------------
  IC100EN1.IPS - Japanese to English translation patch for Illusion City DISK 1.
  IC100EN2.IPS - Japanese to English translation patch for Illusion City DISK 2.
  IC100EN3.IPS - Japanese to English translation patch for Illusion City DISK 3.
  IC100EN4.IPS - Japanese to English translation patch for Illusion City DISK 4.
  IC100EN5.IPS - Japanese to English translation patch for Illusion City DISK 5.
  IC100EN6.IPS - Japanese to English translation patch for Illusion City DISK 6.
  IC100EN7.IPS - Japanese to English translation patch for Illusion City DISK 7.
  IC100EN8.IPS - Japanese to English translation patch for Illusion City DISK 8.

  IC100C1S.IPS - Optional patch (remove save states from DISK 1).

  IC100ENG.TXT - This text file.

     icrom.rcd - Special file to convert "English" disk images into a ROM file.

  rcd_apply.py - Python script to apply icrom.rcd file to the "English" disks.
 rcd_apply.exe - Windows build (no Python required).
                 rcd_apply (Apple silicon) - prebuilt binary in the
		 "apple_m_chip_compiled" folder.



 rcd-apply-user-guide.html - Detailed guide on how to apply RCD file to create
                             ROM version of the translation.

Illusion City Databook.pdf - Translated databook for Illusion City.

  Illusion City Manual.pdf - Translated operations manual for Illusion City.

            survey_ic.html - Link to a survey based on old survey cards, that
	                     asks for input for translation(s).



        IC.RCP - This is the ROM configuration file used by the Carnivore 2
	         utility when flashing the Illusion City ROM to the cartridge.




						 HOW TO PATCH DISKS (IPS METHOD)
--------------------------------------------------------------------------------
Use this if you want to play from floppy or from disk images.

1) Obtain clean dumps of Illusion City disks for MSX Turbo R (DSK). If you own
   the originals but cannot dump them, clean DSK images may be available
   online. Always make backups before patching.


2) Choose an IPS tool:

   -   On MSX: IPS4MSX.COM
   -  Windows: Floating IPS (FLIPS), Lunar IPS
   -    macOS: MultiPatch, UIPS
   -    Linux: Floating IPS (flips)
   - Emulator: openMSX supports soft-patching IPS; see openMSX documentation.


3) Put the IPS tool, the IC100EN*.IPS files, and your DSK files in one folder.


4) Apply each IPS to its matching disk:

   - IC100EN1.IPS -> Disk 1 DSK, ... IC100EN8.IPS -> Disk 8 DSK.
   - Verify your patched DSKs boot on your setup or emulator.


5) If you use a virtual disk loader on MSX, ensure it supports partially file-
   backed disk images; otherwise, write the images to real 2DD media.


Tip: Keep the original (unpatched) DSKs and the patched DSKs in separate folders
     so you always know which is which.



                            HOW TO BUILD THE ROM (RCD -> ROM FROM PATCHED DISKS)
--------------------------------------------------------------------------------
Use this if you want the fast-loading 4MB ROM build.


[ Prerequisites ]

- Python 3 on your PC (Windows/macOS/Linux).
- Your 8 **translated** DSK files (patched with the IPS files above).
- The provided files: icrom.rcd and rcd_apply.py.


[ Steps ]

1) Place icrom.rcd, rcd_apply.py, and your 8 translated DSKs in the same
   directory.


2) Run rcd_apply.py (rcd_apply.bat and rcd_apply_py.bat available for Windows):

   - Windows:  py rcd_apply.py icrom.rcd D1.DSK D2.DSK D3.DSK D4.DSK D5.DSK
               D6.DSK D7.DSK D8.DSK -o illusion_city_en.rom

   - macOS/Linux:  python3 rcd_apply.py icrom.rcd D1.DSK D2.DSK D3.DSK D4.DSK
                   D5.DSK D6.DSK D7.DSK D8.DSK -o illusion_city_en.rom


3) The tool verifies disk hashes (if present in the RCD) and writes the ROM.
   It prints the ROM's SHA-256 so you can verify integrity later.


4) Flash or load the ROM as you prefer:

   - MegaFlashROM SCC+SD: Use OPFXSD on MSX to flash the ROM. You can find
                          required info here: https://msxcartridgeshop.com

   - Carnivore 2: Use the C2 utilities (e.g., C2MAN) to write/run the ROM.
                  IC.RCP file included to auto-select all parameters. You
		  can find out more here: https://github.com/RBSC/Carnivore2

   - ASCII16-X: Flash your ROM using ASCIIXF.COM, press "S" during ROM boot if
                you need to skip auto-start. More details can be found here:
		https://www.grauw.nl/projects/ascii-x-flash/

   - Emulator: load the ROM directly (e.g., openMSX, blueMSX). Download from:
                https://openmsx.org/
		bluemsx.msxblue.com/download.html



Examples:

  For MegaFlashROM SCC+SD: OPFXSD IC.ROM /A16 /U /W
  OPFXSD v1.29 automatically detects the ROM and applies the correct options.


  For ASCII16-X: asciixf /s2 /p ic.rom (if ROM located in slot 2)


  openMSX will automatically select ASCII16-X mapper and will allow saves to
  FlashROM. The ROM can be played with standard ASCII16 mapper as well
  but won't save to FlashROM.



Notes:

- If a strict SHA mismatch is reported, ensure your 8 DSKs are the translated
  ones and match the version this release targets.

- The RCD format is text; do not edit it. The META line is informational and
  ignored by rcd_apply.py.




									 CREDITS
--------------------------------------------------------------------------------

  - Translation Credits -

         232: Translation, research, beta testing, script comparisons, databook

 Max Iwamoto: Reverse engineering, coding, GFX, fonts, redesign, beta testing,
	      tools, final script fixes and polishing



  - Additional Credits -

      SHADOW: Proofing, beta testing, operations manual

	KROP: Proofing, beta testing



  - Special Thanks -

     Vampier: Proofing, beta testing, msxtranslations.com website hosting

Manuel Pazos: Beta testing, updating my MFR+SD to 8MB, few bug fixes

        BiFi: MuPack testing and proofing

       Grauw: for ASCII16-X and more

openMSX team: For the openMSX emulator and support

     ChatGPT: Help with tools creation and more

      Gemini: Help with tools creation and more




								      CONTACT US
--------------------------------------------------------------------------------
   If you find any bugs or just want to contact us, please email to
msx.translations@gmail.com




							       LICENSE AGREEMENT
--------------------------------------------------------------------------------

Illusion City (MSX Turbo R) - English Translation
License: Personal, Non-Commercial Use Only
Version 1.0.0 - 13 Sep 2025


- Scope -

This license applies to the fan-made translation patches, this license text,
the release notes, and the included helper tools (collectively, the "Patch
Archive"). It does not grant rights to any original game data, trademarks, or
other third-party content.



- Permissions -

You may:

- Apply the patches to your own legally obtained copies of the game and play
  the result for yourself (personal, non-commercial use).

- Redistribute the original, unmodified Patch Archive for free, provided that:
  (a) you do not charge money or require registration, and
  (b) you include this text file and keep the archive contents intact.



- Prohibitions -

You may not:

- Sell, rent, license for a fee, or otherwise monetize the patches, tools, or
  any work produced with them (including pre-patched outputs).

- Distribute any ROMs, disk images (DSK), or other copyrighted game data,
  whether patched or unpatched.

- Distribute pre-patched disks or ROMs, or publish the patched results.

- Bundle the patches with copyrighted game data, or host them behind paywalls,
  paid links, or ad-link shorteners.

- Use the Patch Archive or its outputs in any commercial product or service.



- Attribution and Rights -

All copyrights in Illusion City and its assets remain with their respective
owners. This Patch Archive contains only fan-created translation work and
supporting tools. No endorsement by the rightsholders is implied. If any
rightsholder requests removal, we will comply.



- Warranty Disclaimer -

THE PATCH ARCHIVE IS PROVIDED "AS IS" WITHOUT WARRANTIES OF ANY KIND, EXPRESS
OR IMPLIED. USE AT YOUR OWN RISK. WE ARE NOT LIABLE FOR ANY DAMAGE, LOSS OF
DATA, OR OTHER CONSEQUENCES ARISING FROM USE OF THESE FILES.



- Contact -

Bugs, feedback, or rightsholder inquiries: msx.translations@gmail.com




							   PREVIOUS TRANSLATIONS
--------------------------------------------------------------------------------

							   (Japanese to English)
--------------------------------------------------------------------------------
01. Ganbare Goemon v0.9.5 - (c) Konami 1987
02. Yoshida Konzern v0.5.0 and Lubeck v1.0.0 - (c) MSX-MAGAZINE SOFTWARE 1990
03. Woody Poco v1.0.1 - (c) dB-SOFT 1987
04. Penguin Wars 2 v1.0 - (c) ASCII 1988
05. Romancia - Dragon Slayer Jr. MSX2 v1.0.0 - (c) Falcom 1986
06. Dragon Slayer 4 MSX2 v1.0.0 - (c) Falcom 1987
07. Romancia - Dragon Slayer Jr. MSX1 v0.7.0 - (c) Falcom 1986
08. Welcome to Heaven v1.0.2 - (c) Taito 1987
09. Malaya's Treasure v1.0.0 - (c) Pony Canyon 1989
10. Ashguine Story 2: Citadel in the Void v1.0.0 - (c) T&E Soft 1987
11. Firebird v1.0.0 - (c) Konami 1987
12. Gladius v1.0.0 - (c) MP 1992
13. Turtlemania demo MSX2+ version v1.0.0 - (c) Agnes Muller 1992
14. Shot to Another World v1.0.0 - (c) Doku
15. ParaDream v1.0.0 - (c) RAC House 1992
16. Mr. Ghost v1.0.0 - (c) System Sacom 1989
17. Sorcerer Lulba v1.0.0 - (c) Compile 1988
18. Puyo Puyo v1.0.0 - (c) Compile 1990
19. Maze v1.0.0 - (c) Compile 1988
20. Super Shang Hai Dragon's Eye v1.0.0 - (c) Hot B 1991
21. Turbo Booster v1.0.0 - (c) Kyoto Media 1990
22. Nyan Puzzle v1.0.0 - (c) Compile 1990
23. Yoshida Koumuten v1.0.0 - (c) ASCII 1988
24. Yoshida Koumuten Data Library Vol.1 - (c) ASCII 1988
25. Yoshida Koumuten Data Library Vol.2 - (c) ASCII 1988
26. Saladerman - (c) 1988
27. Final Potential - (c) ASCII 1990
28. Daisenryaku - (c) Microcabin 1986
29. Daisenryaku Map Selection - (c) Microcabin 1986
30. Anti-Life Trooper Androgynous a.k.a. Hanseimei Senki Andorogynus v1.0.0
31. Tako and Ika 3 - (Octopus and Squids 3)
32. Vilzam - (c) Yuichi Toyama 1985
33. Action RPG Construction Tool Dante 2
34. Seed of the Dragon (Dragon's Descendant) v1.0.0 - (c) 1990 Riverhill Soft


- Soon to be released -

XX. Mashou Denki La Valeur - (c) Kogado Studio 1990



				     			   (Japanese to Spanish)
--------------------------------------------------------------------------------
01. Romancia - Dragon Slayer Jr. MSX1 v0.7.0 - (c) Falcom 1986



				     			      (Dutch to English)
--------------------------------------------------------------------------------
01. Tempo Typing MSX1 v1.0.0 - (c) Radar Soft 1986
02. MT Base - (c) Micro Technology 1985
03. Brisk - (c) Triple Soft 1993

--------------------------------------------------------------------------------